The MMEMory system provides mass storage capabilities for the analyzer.
Internal
and external mass storage
The mass storage of the analyzer may be internal or external. The internal mass storage device can be any section of the internal hard disk (mapped to drive C:\). The external mass storage device can be a floppy disk inserted into the drive at the front panel of the instrument, which is mapped to drive a:\ (see MMEMory:MSIS), a USB memory stick connected to one of the USB ports (mapped to any free drive letter) or a network connection.
The <file_name> and <directory_name> parameters are strings. Some commands use a fixed directory; for others the <file_name> can contain the complete path including the drive name and all subdirectories, e.g. 'C:\TEMP\TRASH\test.txt' for the file named test.txt in the TEMP\TRASH subdirectory of the internal hard disk drive C:\. If no complete path is specified, the file location is relative to the current directory (queried with MMEMory:CDIRectory?). The file name itself may contain the period as a separator for extensions.
File and directory names can be chosen according to Windows™ conventions; the restrictions placed on file names known from DOS systems do not apply. All letters and numbers are allowed, as well as the special characters "_", "^", "$", "~", "!", "#", "%", "&", "-", "{", "}", "(", ")", "@" and "`". Reserved file names are CON, AUX, COM1, ..., COM4, LPT1, ..., LPT3, NUL and PRN.
The use of wildcards ? and * is not allowed.
Command tree: MMEMory
:AKAL
:FACTory
:LOAD
:VNETworks<Ch>
:BALanced
:SENDed
:STORe
Converts the calibration data of the standards in the active calibration unit (SYSTem:COMMunicate:RDEVice:AKAL:ADDRess) to Touchstone format and copies it to the specified directory.
|
'<directory_name>' |
String parameter to specify the directory. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, command or query (returns the current directory).
|
|
Example: |
|
Returns the contents of the current or of a specified directory.
Use MMEMory:CATalog:ALL?
to query the contents of the current directory and all subdirectories.
|
'<directory_name>' |
String parameter to specify the directory. If the directory is omitted, the command queries the contents of the current directory, to be queried with MMEMory:CDIRectory?
|
|
Response |
Directory information in the following format: The first two numeric parameters denote the total amount of storage currently used in the directory and the total amount of storage available, both expressed in bytes. All files are returned with their file name and their size in bytes. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, query only.
|
|
Example: |
|
Returns the contents of the current or of a specified directory and all subdirectories.
Use MMEMory:CATalog?
to query the contents of the current directory.
|
'<directory_name>' |
String parameter to specify the directory. If the directory is omitted, the command queries the contents of the current directory, to be queried with MMEMory:CDIRectory?
|
|
Response |
Directory information in the following format: The first line is omitted if the current directory contains no subdirectories. The following lines are analogous to the output of MMEMory:CATalog?. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, query only.
|
|
Example: |
|
Changes the default directory for mass memory storage.
|
'<directory_name>' |
String parameter to specify the directory. |
|
*RST value |
– (A *RST does not change the current directory)
|
|
SCPI, Command Types |
Confirmed, command or query (returns the current directory).
|
|
Example: |
|
Copies an existing file to a new file.
|
'<file_source>', '<file_destination>' |
String parameters to specify the name of the file to be copied and the name of the new file. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Loads <data> into the file <file_name>.
|
'<file_name>' |
String parameter to specify the name of the file.
|
|
<data> |
Data in 488.2 block data format. The delimiter EOI must be selected to achieve correct data transfer. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, with query. The query form is MMEMory:DATA? <file_name> with the response being the associated <data> in block format.
|
|
Example: |
|
Removes a file from the specified directory.
|
'<file_name>' |
String parameter to specify the name and directory of the file to be removed.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Deletes a system error correction data set stored in the cal pool (cal group file).
|
'<file_name>' |
String parameter to specify the name of the cal group
file to be deleted. Cal group files must have the extension *.cal. The
directory path must not be specified; the analyzer always uses the default
cal pool directory
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads cal kit data from a specified NWA cal kit file.
|
'<file_name>' |
String parameter to specify the name and directory of the cal kit file to be loaded. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?. Note: The loaded file must be a NWA-specific cal kit file with the extension *.calkit. ZVR cal kit files can be imported using the [SENSe<Ch>:]CORRection:CKIT:INSTall command. Agilent cal kit files can be imported manually and converted into *.calkit files.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads cal kit data for a specific connector type, cal kit, and calibration standard from a specified Touchstone file, assigning a label for the cal data. A restriction on the port assignment may be defined in addition.
|
'<conn_name>' |
String parameters containing the name of the connector type.
|
|
'<ckit_name>' |
String parameters containing the name of a calibration kit available on the analyzer.
|
|
Parameters |
Standard type; for a description refer to the table of standard types.
|
|
'<stdlabel_name>' |
String parameter defining a label for the cal kit data. An empty string means that no label is defined.
|
|
'<file_name>' |
String parameter to specify the name and directory of the Touchstone file to be loaded. A *.s1p file must be used for one-port standards, a *.s2p file for two-port standards. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
<port1_no>, <port2_no> |
Port assignment: One port number for one-port standards, two port number for two-port standards. If the port numbers are omitted, the cal kit data is valid for all ports.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Connector
and cal kit naming conventions
Connector and calibration kit names must be entered as string parameters. The strings contain the connector and cal kit names used in the Calibration Kits dialog; a W in the name must be replaced by 'Ohm', e.g.:
'NewKit1' denotes the user-defined calibration kit NewKit1.
'N 50 Ohm Dummy Kit' denotes the N 50 W Dummy Kit.
'ZV-Z21 typical' denotes the cal kit ZV-Z21 typical.
Loads a color scheme from a specified NWA color scheme file.
|
'<file_name>' |
String parameter to specify the name and directory of the cal kit file to be loaded. The default extension (manual control) for color scheme files is *.ColorScheme, although other extensions are allowed.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
Color the first trace red, the second trace green.
|
Applies a system error correction data set stored in the cal pool (cal group file) to channel no. <Ch>.
|
<Ch> |
Channel number of an existing channel
|
|
<file_name> |
String parameter to specify the name of the cal group
file to be loaded. Cal group files must have the extension *.cal. The
directory path must not be specified; the analyzer always uses the default
cal pool directory
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Resolves the link between channel <Ch> and the correction data set (cal group file) so that the channel uses its previous correction data.
|
<Ch> |
Channel number
|
|
'<file_name>' |
Optional string parameter to specify the name of the cal
group file. Cal group files must have the extension *.cal. The directory
path must not be specified.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads a limit line definition from a specified file and assigns it to a trace with a specified name. Limit lines are created using the CALCulte<Chn>:LIMit... commands.
|
'<trc_name>' |
Name of an existing trace in the active setup (string parameter). The imported limit line is assigned to this trace, irrespective of the trace information in the limit line file.
|
|
'<file_name>' |
String parameter to specify the name and directory of the limit line file to be loaded. The default extension (manual control) for limit line files is *.limit, although other extensions are allowed. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads a sweep segment definition from a specified file and assigns it to a specified channel. Sweep segments are defined using the [SENSe<Ch>:]SEGMent<Seg>... commands.
|
<Ch> |
Channel number.
|
|
'<file_name>' |
String parameter to specify the name and directory of the sweep segment file to be loaded. The default extension (manual control) for sweep segment files is *.seglist, although other extensions are allowed. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads configuration data from a specified setup file and sets the analyzer to the corresponding instrument state.
|
<numeric_value> |
1 (the <numeric_value> is used for compatibility with the SCPI standard but is ignored).
|
|
<file_name> |
String parameter to specify the name and directory of the setup file to be loaded. The default extension (manual control) for setup files is *.zvx, although other extensions are allowed. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Loads trace data from a specified trace file and assigns it to a trace with a specified name. Traces are created using the CALCulte<Ch>:PARameter:SDEFine... command.
|
'<trc_name>' |
Name of an existing data trace in the active setup (string parameter). The trace data is loaded into a memory trace associated with the specified data trace. If one or more memory traces are already associated with the specified data trace, the last generated memory trace is overwritten.
|
|
'<file_name>' |
String parameter to specify the name and directory of the trace file to be loaded. Several file formats for trace files are supported. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
'<parameter_name>' |
Optional parameter for imported Touchstone files for more than one port (*.s2p, *.s3p, *.s4p); denotes the imported S-parameter (S11, S12, ...). If nothing is specified, the first trace in the specified is imported. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Loads data from a specified Touchstone file defining the characteristics of the current deembedded balanced port circuit model. A balanced port circuit model involving file import must be selected before using the command.
|
<Ch> |
Channel number
|
|
<Log_pt> |
Logical port number |
|
'<file_name>' |
String parameter to specify the name and directory of the loaded Touchstone file. The balanced port circuit models STSL | STSC | SLST | SCST require two 2-port (*.s2p) files, to be assigned to the different ports PMAin and PSECondary; the FIMPort model requires a single 4-port (*.s4p) file but no additional port assignment. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
Parameters |
Port assignment for two 2-port (*.s2p) files: The ports must be specified for the import of 2-port (*.s2p) files; they must be omitted for 4-port (*.s4p) files. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
Define a balanced port configuration.
|
Loads data from a specified Touchstone file defining the characteristics of the current embedded balanced port circuit model. A balanced port circuit model involving file import must be selected before using the command.
|
<Ch> |
Channel number
|
|
<Log_pt> |
Logical port number
|
|
'<file_name>' |
String parameter to specify the name and directory of the loaded Touchstone file. The balanced port circuit models STSL | STSC | SLST | SCST require two 2-port (*.s2p) files, to be assigned to the different ports PMAin and PSECondary; the FIMPort model requires a single 4-port (*.s4p) file but no additional port assignment. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
Parameters |
Port assignment for two 2-port (*.s2p) files: The ports must be specified for the import of 2-port (*.s2p) files; they must be omitted for 4-port (*.s4p) files. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
Define a balanced port configuration.
|
Loads data from a specified two-port (*.sp2) Touchstone file defining the characteristics of the current deembedded single ended port circuit model. The single ended port circuit model involving file import (FIMPort) must be selected before using the command.
|
<Ch> |
Channel number.
|
|
<Ph_pt> |
Physical port number |
|
'<file_name>' |
String parameter to specify the name and directory of the loaded Touchstone file. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Loads data from a specified two-port (*.sp2) Touchstone file defining the characteristics of the current embedded single ended port circuit model. The single ended port circuit model involving file import (FIMPort) must be selected before using the command.
|
<Ch> |
Channel number.
|
|
<Ph_pt> |
|
|
'<file_name>' |
String parameter to specify the name and directory of the loaded Touchstone file. If no path is specified the analyzer searches the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Creates a new directory for mass memory storage.
|
'<directory_name>' |
String parameter to specify the directory. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Copies an existing file to a new file.
|
'<file_source>', '<file_destination>' |
String parameters to specify the name of the file to be copied and the name of the new file. |
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Defines a name for a file which can be used to store the printer output. The file is created when it is selected as a printer destination (HCOPy:DESTination 'MMEM').
|
'<file_name>' |
String parameter to specify the file name. The supported file formats are *.wmf, *.ewmf, *.bmp, *.png; see command HCOPy:DEVice:LANGuage. The specified directory must exist, otherwise no file can be generated. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?. |
|
*RST value |
'Hardcopy'
|
|
SCPI, Command Types |
Device-specific, with query.
|
|
Example: |
|
Removes an existing directory from the mass memory storage system.
|
'<directory_name>' |
String parameter to specify the directory. |
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Stores the data of a calibration kit to a specified file.
|
'<kit_name>' |
Name of a user-defined calibration kit available on the analyzer. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?. Note: Predefined or dummy kits can neither be modified nor be stored.
|
|
'<file_name>' |
String parameter to specify the name and directory of the cal kit file to be created. The file is a NWA-specific cal kit file with the extension *.calkit.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Stores a color scheme to a specified NWA color scheme file.
|
'<file_name>' |
String parameter to specify the name and directory of the cal kit file to be created. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?. The default extension (manual control) for color scheme files is *.ColorScheme, although other extensions are allowed.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Copies the correction data of channel <Ch> to the
cal pool, generating a new correction data file (cal group). The file
has the extension *.calkit and is stored in the C:\Rohde&Schwarz\NWA\Calibration\Data directory.
|
<Ch> |
Channel number
|
|
'<file_name>' |
String parameter to specify the name of the created cal
group file. The directory path must not be specified; the analyzer always
uses the default cal pool directory
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Saves the limit lines associated to a specified trace to a limit line file. Limit lines are created using the CALCulte<Chn>:LIMit... commands.
|
'<trc_name>' |
Name of an existing trace in the active setup (string parameter) for which a limit line definition exists.
|
|
'<file_name>' |
String parameter to specify the name and directory of the created limit line file. The default extension (manual control) for limit line files is *.limit, although other extensions are allowed. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Saves the values of all markers to a ASCII file.
|
'<file_name>' |
String parameter to specify the name and directory of the created ASCII file. The default extension (manual control) for marker files is *.txt, although other extensions are allowed. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?. An example for the file contents is given below.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Saves the sweep segment definition of a specified channel to a sweep segment file. Sweep segments are defined using the [SENSe<Ch>:]SEGMent<Seg>... commands.
|
<Ch> |
Channel number.
|
|
'<file_name>' |
String parameter to specify the name and directory of the created sweep segment file. The default extension (manual control) for sweep segment files is *.seglist, although other extensions are allowed. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Device-specific, no query.
|
|
Example: |
|
Stores the configuration data of the current setup to a specified setup file.
MMEMory:STORe:STATe
renames the current setup, appending a .zvx extension. See example for
MMEMory:LOAD:STATe.
|
<numeric_value> |
1 (the <numeric_value> is used for compatibility with the SCPI standard but is ignored).
|
|
'<file_name>' |
String parameter to specify the name and directory of the created setup file. The default extension (manual control) for setup files is *.zvx, although other extensions are allowed. If no path is specified the analyzer uses the current directory, to be queried with MMEMory:CDIRectory?.
|
|
*RST value |
–
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|
Stores the trace data of a specified trace to a trace file. Traces are created using the CALCulte<Ch>:PARameter:SDEFine... command.
*.s<n>p Touchstone files (<n>
= 2, 3,, 4) are intended for a complete set of <n>-port S-parameters.
Data export fails if the active channel does not contain the full set
of <n>2 traces. If the
necessary trace are available, '<trc_name>' can be the name of any
of the traces.
|
'<trc_name>' |
Name of an existing data trace in the active setup (string parameter).
|
|
'<file_name>' |
String parameter to specify the name and directory of
the created trace file. Several file
formats
for trace files are supported. If no path is specified the analyzer uses
the
|
|
Optional parameters |
UNFormatted –
Specifies unformatted (complex) data export If the optional parameter is omitted the command stores unformatted data.
|
|
*RST value |
– (the default export format is UNFormatted)
|
|
SCPI, Command Types |
Confirmed, no query.
|
|
Example: |
|